package com.lxx.jmb2c.controller;

import io.swagger.v3.oas.annotations.tags.Tag;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

/**
 * 后台角色管理控制器
 * 
 * 这个控制器将处理所有与后台角色相关的HTTP请求，包括：
 * 1. 角色创建和删除
 * 2. 角色权限分配
 * 3. 角色列表查询
 * 
 * 待实现功能(TODO):
 * - 添加角色CRUD接口
 * - 实现角色-权限关联管理
 * - 添加角色分页查询
 * 
 * 初学者需要了解：
 * - 角色(Role)是权限的集合，用于控制用户能访问哪些资源
 * - 通常一个用户可以拥有多个角色
 * - 角色管理是RBAC(基于角色的访问控制)的核心部分
 * 
 * Knife4j文档说明：
 * 访问 http://localhost:8080/doc.html 可以查看接口文档
 * 
 * @author lxx
 * @since 2025-07-07
 */
@Tag(name = "角色管理", description = "后台角色分组管理接口")
@RestController
@RequestMapping("/adminRole")
public class AdminRoleController {

    /*
     * 待开发接口示例：
     * 
     * 1. 创建角色
     * @PostMapping
     * public Result createRole(@RequestBody RoleCreateDTO dto)
     * 
     * 2. 分配权限
     * @PutMapping("/{roleId}/permissions")
     * public Result assignPermissions(@PathVariable Long roleId, @RequestBody List<Long> permissionIds)
     * 
     * 3. 获取角色列表
     * @GetMapping
     * public Result<List<RoleVO>> listRoles()
     */
}
